home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / cli / MayFlower.lha / MayFlower / LookIn / LookIn.doc < prev    next >
Text File  |  1994-05-04  |  5KB  |  103 lines
  1.             ---  ---
  2.            ( o) ( o)      Lookin 4.0 (19940308)
  3.                ^
  4.             \_____/       by Stephen D. Childers
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7. Program Description:
  8.  
  9.    1) LookIn will let you look at the data from any location within a
  10.       file, data will be displayed in hex. Printable characters will
  11.       also be displayed in text format after the hex data format,
  12.       unprintable characters will be displayed as a period.
  13.  
  14.    2) Can only be used from CLI. Can be made resident.
  15.  
  16.    3) Program (when run from CLI) will interact with the 'c:Why' command
  17.       after program failures; this command may provide a more detailed
  18.       explanation of why the program failed. The 'Why' command should be
  19.       used immediately after a program failure to extract the last
  20.       program's result code, because that result code is changed upon the
  21.       execution of the next CLI command.
  22.  
  23.    4) Certain error reports will contain the name of the argument, file,
  24.       device, (etc) that is associated with failure when it occurs.
  25.  
  26. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  27. CLI Usage:
  28.  
  29.     > LookIn [!|?] [[-options] file location range]
  30.  
  31.        ! = show author info
  32.        ? = show some help
  33.  
  34.        -options a = Do not show address line number
  35.                 c = Show as hex for C compiler, will set option a
  36.                 t = Do not show text portion at end of hex data
  37.  
  38.        file     = Any file.
  39.  
  40.        location = The location offset (hex or decimal) within file.
  41.                   The range of input values are:
  42.                     Hex     = H1 to H7fffffff
  43.                     Decimal = 1 to 2147483647
  44.                   Hex value must be preceded with 'h'
  45.  
  46.        range    = The amount of file data to show. An optional keyword
  47.                   "end" may be used here for displaying data from the
  48.                   location to end of file.
  49.  
  50. CLI Example:
  51.  
  52.      ie > Looken -ct Looken 1 end
  53.      or > Looken >rad:test -ct Looken 1 end
  54.  
  55. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56. Version History:
  57.  
  58.    The following information briefly describes changes or improvements
  59.    made to each version, and they will be described in descending order;
  60.    meaning latest version information begins first:
  61.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  62.    Version 4.0 (19940308) -
  63.    1) Changed version numbering format. Program can now be used with the
  64.       "Version" command. Date within parenthesis is shown in a somewhat
  65.       international format as (yyyymmdd).
  66.    2) Added optional keyword "end" which is used with the <range> arg
  67.       and is used for displaying data from <location> to end of file.
  68.    3) Enhanced option -c
  69.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  70.    Version 19930729 -
  71.    1) Optimized and refined source code thereby making program smaller.
  72.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  73.    Version 19920111 -
  74.    1) Removed a CLI parsing problem.
  75.    2) Can be made resident.
  76.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  77.    Version 19911004 - The first version.
  78.  
  79. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80.      /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\
  81.     /)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(_)(\
  82.    //                                                                 \\
  83.    \\      1   The burden of the word of the Lord for Israel, saith   //
  84.    //   the Lord, which stretcheth forth the heavens, and layeth the  \\
  85.    \\   foundation of the earth, and formeth the spirit of man        //
  86.    //   within him.                                                   \\
  87.    \\      2   Behold, I will make Jerusalem a cup of trembling unto  //
  88.    //   all the people round about, when they shall be in the siege   \\
  89.    X    both against Judah and against Jerusalem.                      X
  90.    \\      3   And in that day will I make Jerusalem a burdensome     //
  91.    //   stone for all people: all that burden themselves with it      \\
  92.    \\   shall be cut in pieces, though all the people of the earth    //
  93.    //   be gathered together against it.                              \\
  94.    \\                                                                 //
  95.    //                    King James Holy Bible - Zechariah 12:1-3     \\
  96.    \\  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  //
  97.     \)( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )( )(/
  98.      \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/
  99.  
  100. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  101.                               End Of Document
  102.  
  103.